home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / CVOUTILS.ARJ / MANUAL < prev    next >
Text File  |  1992-03-18  |  42KB  |  1,192 lines

  1.  
  2.  
  3.                              CVO Utilities
  4.  
  5.  
  6.                    Copyright Notice and Software License
  7.  
  8.               **********************************************
  9.               *                                            *
  10.               *         This is  not free  software.       *
  11.               *                                            *
  12.               **********************************************
  13.  
  14.  This document, other accompanying written and disk-based notes and
  15.  specifications, and all referenced and related program files, accompanying
  16.  this document are copyrighted by CVO, a French corporation. The copyright
  17.  owner hereby licenses you to: make as many copies of the software and
  18.  documentation as you wish; give exact copies of the original to anyone; and
  19.  distribute the software and documentation in its unmodified form via
  20.  electronic means. There is no charge for any of the above.
  21.  
  22.  You are specifically prohibited from charging or requesting donations for any
  23.  such copies, however made. Exceptions may be granted to organizations which
  24.  charge a small fee for materials, handling, postage and general overhead. NO
  25.  ORGANIZATION IS AUTHORIZED TO CHARGE ANY AMOUNT FOR DISTRIBUTION OF THE
  26.  SOFTWARE OR DOCUMENTATION UNDER ANY OTHER CONDITIONS.
  27.  
  28.  
  29.  This license allows you to use this software without charge for a period of
  30.  30 days only.
  31.  
  32.  If you wish to continue using this software in all or in part, you must
  33.  register, using the Register Form below, and paying the Registration Fee.
  34.  Registration fee for this softawre is a one-time payment of $30 for use
  35.  on one machine only.
  36.  
  37.  No copy of the software may be distributed or given away without this
  38.  accompanying documentation; this notice must not be removed.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.                                  Warranty
  45.  
  46.  There is no warranty of any kind associated with this software, and the
  47.  copyright owner is not liable for damages of any kind. By using this software,
  48.  you agree to this. Every effort has been made by the author to make this
  49.  product bug-free. However, the nature of software development is that it is
  50.  impossible to guarantee bug-free software.
  51.  
  52.  In the event a verifiable bug is found, the author's only obligation will be
  53.  to make every attempt to repair the bug as soon as possible.
  54.  
  55.  
  56.  
  57.  
  58.                                 Order Form
  59.  
  60.                       CVO Utilities Registration Form
  61.  
  62.  
  63.      Name:          ______________________________________
  64.  
  65.      Address:       ______________________________________
  66.  
  67.                     ______________________________________
  68.  
  69.      City:          ______________________________________
  70.  
  71.      State:         __________________________ Zip: ______
  72.  
  73.      Telephone:     ______________________________________
  74.  
  75.  
  76.      Item                                      Quantity      Total
  77.      --------------------------------------------------------------
  78.  
  79.      One-time fee for the first machine.........   1         $  30
  80.  
  81.      for multi-users only:
  82.      $ 5 fee per machine using this software
  83.      within the same organization...............
  84.  
  85.      --------------------------------------------------------------
  86.      Total Due:                                           _________
  87.  
  88.  
  89.      Payment thru:     VISA
  90.                    or  check
  91.  
  92.  
  93.      Preferred Disk Size:  3.5" ____  5.25" ____
  94.  
  95.  
  96.      Mail Completed Form to:
  97.  
  98.  
  99.                   DPTool Club
  100.                   BP 745
  101.                   59657 Villeneuve d'Asq
  102.                   FRANCE
  103.  
  104.  
  105.  
  106.  ______________________________________________________________________________
  107.  
  108.  
  109.  
  110.                               A Set of Utilities,
  111.               developped over the years, whenever the need arises,
  112.                                   or a fancy.
  113.  
  114.  
  115.  
  116.  ______________________________________________________________________________
  117.  attr
  118.  ______________________________________________________________________________
  119.  
  120.  Usage:      attr [-flags ...] filespec filespec ...
  121.  
  122.  Finds all specified files (wildcards allowed) with archive bit set in the
  123.  current directory.
  124.  
  125.   Flags:      -i  lists files with archive bit reset.
  126.               -r  recursively searchs subdirectories.
  127.               -c  displays absolute path.
  128.               -n  displays only file names.
  129.               -p  pauses every 20 lines.
  130.               -h  or ?, displays a help screen
  131.  ______________________________________________________________________________
  132.  bakdel
  133.  ______________________________________________________________________________
  134.  
  135.  Usage:       bakdel
  136.  
  137.  Deletes all .bak files from current and subdirectories. Pauses every 20 lines.
  138.  
  139.  ______________________________________________________________________________
  140.  bckctl
  141.  ______________________________________________________________________________
  142.  
  143.  Usage:       bckctl [u:]control.xxx
  144.  
  145.  Lists the content of a backup disk with path and file names.
  146.  
  147.  ______________________________________________________________________________
  148.  catcmp
  149.  ______________________________________________________________________________
  150.  
  151.  Usage:      catcmp first_directory second_directory
  152.  
  153.  Compares two dictories and displays in three columns: files exclusive to the
  154.  first directory, files exclusive to the second directory and common files.
  155.  
  156.  Use Esc and arrows to move from one list to the other. Quit with Esc.
  157.  
  158.  ______________________________________________________________________________
  159.  
  160.  
  161.  
  162.  _____________________________________________________________________________
  163.  catlin
  164.  ______________________________________________________________________________
  165.  
  166.  Usage
  167.              catlin [-x or -d] [-y -c] file file ...
  168.  
  169.  displays a list of selected files in alphabetical order.
  170.  
  171.  Flags:
  172.            -c      displays the absolute path
  173.            -y      chronological order
  174.  
  175.            -x      to select and display files (See Expose)
  176.            -d      to select and erase files
  177.  
  178.  Catlin ? displays a help screen
  179.  ______________________________________________________________________________
  180.  catlist
  181.  ______________________________________________________________________________
  182.  
  183.  
  184.  Usage:      catlist [-flag...] filespec filespec ...
  185.  
  186.  Finds all specified files  (wildcards allowed) in the current directory.
  187.  
  188.   Flags       -r   recursively searchs subdirectories.
  189.               -aN  displays only files with mode bit N (0-7). See chmod.
  190.               -d   displays directories only.
  191.               -c   displays absolute path.
  192.               -n   displays only filenames.
  193.               -p   pauses every 20 lines.
  194.               -v   displays length, date and time.
  195.               -o   computes disk occupation in bytes and clusters of
  196.                    current drive.
  197.  
  198.  _____________________________________________________________________________
  199.  catname
  200.  ______________________________________________________________________________
  201.  
  202.  Usage:      catname filespec
  203.  
  204.  Displays a list of selected files (wildcards allowed) in alphabetical order.
  205.  Then you can select any file and rename it. Catname is useful in renaming a
  206.  file whose name is accidentally unacceptable for DOS.
  207.  
  208.  _____________________________________________________________________________
  209.  catsort
  210.  ______________________________________________________________________________
  211.  
  212.   Usage:       catsort
  213.  
  214.  Sorts the directory in alphabetical order. For safety reasons, it can take a
  215.  while on a big directory and it does not sort root.
  216.  
  217.  _____________________________________________________________________________
  218.  chkdt
  219.  ______________________________________________________________________________
  220.  
  221.  Usage:       chkdt  dummy_arg
  222.               chkdt  [-i]
  223.  
  224.  With a dummy arg, chkdt displays the system date as an unsigned number. (See
  225.  xdate)
  226.  
  227.  Without arg, chkdt waits for key entry of an unsigned date and returns 0 if
  228.  this date is greater than, or equal to, system date. Otherwise it returns the
  229.  difference (up to 255).
  230.  
  231.  Flag -I reverses the test.
  232.  
  233.  Chkdt is useful in testing that system date is acceptable. For instance:
  234.  
  235.  1. Create a file DATE.TST as follows:
  236.  
  237.                   c:
  238.                   cd \
  239.                   echo 65534 >date.tst
  240.  
  241.  2. add to your autoexec.bat:
  242.  
  243.  
  244.          @chkdt <date.tst
  245.          @if errorlevel 1 goto DATE_ERROR
  246.          @goto DATE_END
  247.  
  248.          :DATE_ERROR
  249.          @echo Either System Date or Battery seems out of order
  250.          @echo Check date and time now
  251.          DATE
  252.          TIME
  253.  
  254.          :DATE_END
  255.          @chkdt dummy >c:\date.tst
  256.  
  257.  3. restart system twice.
  258.  
  259.  
  260.  Chkdt is useful also to see if somebody makes backups regularly:
  261.  
  262.  First have a .bat file like:
  263.  
  264.                 @backup c:\appl\*.* a: /s
  265.                 @chkdt dummy >c:\appl.tst
  266.  
  267.  then add to your autoexec.bat:
  268.  
  269.                 @chkdt -i <c:\appl.tst
  270.                 @if errorlevel 3 goto _MISSING_BACKUP
  271.                 @goto _REGULAR_BACKUP
  272.  
  273.                 :_MISSING_BACKUP
  274.                 @echo No APPL backup done since 3 or more days, you lazy !
  275.                 :_REGULAR_BACKUP
  276.  
  277.  _____________________________________________________________________________
  278.  chmod
  279.  _____________________________________________________________________________
  280.  
  281.  Usage:       chmod  file_name  acces_mode
  282.  
  283.  Changes the acces mode to
  284.  
  285.               0       no qualification
  286.               1       read only
  287.               2       hidden
  288.               3       (read only, hidden)
  289.               4       system
  290.               5       (read only, system)
  291.               6       (hidden, system)
  292.               7       (read only, hidden, system)
  293.  
  294.  ______________________________________________________________________________
  295.  columns
  296.  ______________________________________________________________________________
  297.  
  298.  Usage:
  299.            Columns lines chars n_tab tab1 tab2 .... <file
  300.  
  301.               lines:          number of lines
  302.                               (paper height less your top margin)
  303.               chars:          number of char columns on your paper
  304.               n_tab:          number of tabs
  305.               tab1, tab2...   each printed column first char
  306.  
  307.   Example:
  308.                columns 60 150 2 0 75 <doc >prn
  309.  
  310.  would print doc file in two columns of 60 lines on a 150 chars wide paper.
  311.  First column would start at 0, second column at 75. Assuming the printer has
  312.  been set up to 11 inch paper and 12cpi, you would obtain two parallel pages.
  313.  
  314.  Number of tabs is limited only by the number of characters acceptable on a
  315.  command line.
  316.  
  317.  ______________________________________________________________________________
  318.  concat.c
  319.  ______________________________________________________________________________
  320.  
  321.  Usage:    concat [-a or -b] [-d or -w] [-q] destination file1 file2...
  322.  
  323.  Appends file1, file2 etc. to destination.
  324.  Wildcards are allowed in the file(x) names.
  325.  
  326.  Flags:
  327.                -d         deletes source files without warning
  328.                -w         deletes source files after YN prompt
  329.                           default is NO delete
  330.                -q         dont display progress
  331.  
  332.                -a         all files are ascii
  333.                -b         all files are binary
  334.                           DEFAULT is binary
  335.  
  336.  
  337.  With -a flag, end-of-file mark will be removed. Otherwise, all files are
  338.  assumed to be binary. However the program would eventually find out text
  339.  files and request confirmation.
  340.  
  341.  NOTES: as compared to many of similar programs, concat has an advantage and a
  342.  drawback:
  343.  
  344.   1. Naming the destination file in the list of source files DOES NOT destroy
  345.      destination file.
  346.  
  347.   2. Dont forget the -a flag if you concat text files. If you forget it,
  348.      the end-of-file mark (hexa 1A) will not be removed and a part of
  349.      destination file may not be readable. If you have made this mistake
  350.      EX1A utility can repair your file.
  351.  
  352.  ______________________________________________________________________________
  353.  c_print
  354.  ______________________________________________________________________________
  355.  
  356.  Usage:  c_print  file_name  record  description  destin
  357.  
  358.  translates a fixed length record text file to a binary file.
  359.  
  360.       file_name is the name of a text file,
  361.       record is the length of each record (CRLF include)
  362.  
  363.       description is similar to a(0)6u(26)5f(6)8
  364.       where:
  365.  
  366.                (n)        is the data offset within the record
  367.  
  368.                A(..)n     n ascii characters
  369.                I(..)n     an integer to be printed into n columns
  370.                U(..)n     an unsigned integer
  371.                L(..)n     a long integer
  372.                F(..)n     a float
  373.                D(..)n     a double
  374.                C(..)n     a double * 100
  375.                Y(..)      a date (DD MM YY)
  376.                X(..)n     insert n binary zeros
  377.  
  378.       destin is the name of the binary file.
  379.  
  380.  ______________________________________________________________________________
  381.  cpyext
  382.  ______________________________________________________________________________
  383.  
  384.  Usage:    cpyext   file_1 record_length_1    file_2 record_length_2
  385.  
  386.  
  387.  Copies file_1 to file_2, record by record. If length_2 is less than length_1,
  388.  each record is truncated. Otherwise each record is padded with trailing
  389.  binary zeros.
  390.  
  391.  ______________________________________________________________________________
  392.  delfdate
  393.  ______________________________________________________________________________
  394.  
  395.  Usage
  396.          delfdate [-d -p] days files...
  397.  
  398.  deletes specified files if 'days' old as compared to system date. Wildcard
  399.  are allowed, even in directory names.
  400.  
  401.  Flags:
  402.             -d  deletes the directory if empty
  403.             -p  requires confirmation before deleting
  404.  
  405.  Example:
  406.             delfdate -p  90  b:\cl\fct.*\*.tmp
  407.  
  408.  ______________________________________________________________________________
  409.  dirdel
  410.  ______________________________________________________________________________
  411.  
  412.  Usage:   dirdel
  413.  
  414.  Displays name and removes subdirectories if empty.
  415.  ______________________________________________________________________________
  416.  dprint
  417.  ______________________________________________________________________________
  418.  
  419.  Usage:  dprint  file_name  [>output]
  420.          where   file_name is the name of a parameter file.
  421.  
  422.  Dprint formats a binary file to standard output, a file or a printer.
  423.  
  424.           Parameter file contains for instance:
  425.  
  426.    F filename                          the name of the binary file
  427.    L 26                                its record length
  428.    D a(0)6u(6)5y(8)d(10)+12.2x(0)12    first line description of the output
  429.    D x(0)6x(0)5x(0)8x(0)12d(18)+12.2   second line description
  430.    O -g                                a flag
  431.    O -p66.5                            another flag
  432.  
  433.  Except for D'lines, parms order is immaterial. Max.D: 10 lines
  434.  
  435.  D lines describe the input and its formatting, like:
  436.                 a(0)6u(26)5f(6)+8.2d(20)10.2
  437.  
  438.              (x)        is the data offset within the record
  439.  
  440.             A(x)n       n ascii characters
  441.             I(x)n,U(x)  prints an Integer (Unsigned) into n columns
  442.             L(x)n       a long integer
  443.             F(x)n.m     prints a float into n col. including . and m decimals
  444.             D(x)n.m     a double
  445.             C(x)n.m     a double which will be divided by 100
  446.  
  447.             Y(x)        a numerical date MM DD YY
  448.             X(0)n       a dummy variable to be replaced by n blanks.
  449.  
  450.             + (like I(5)+4 or D(9)+10.2) summs the variable. See -a below
  451.  
  452.  Flags:
  453.          -sSTRING   uses STRING as separator - default is a space,
  454.          -sNULL     no separator
  455.          -s124      uses | as separator ('<' and '>' are illegal)
  456.          -pn.m      formfeeds m lines before nth line (default is nothing)
  457.          -n         counts pages starting at 2 (valid only with -p)
  458.          -cnn       counts lines starting at nn up to 65500
  459.          -g         adorns with semigraphics (or *,|,-  if -s124 is active)
  460.          -d         inserts blank lines
  461.          -a         prints + noted variables summation.
  462.          -ttexte    add 'texte' as a title to first page. Can be repeated.
  463.          -fname     prints 'name' file on top of first page.
  464.          -mnn       nn chars left margin
  465.          -hn        1 = 10cpi, 2 = 12cpi, 3 = 16cpi.
  466.  
  467.  ______________________________________________________________________________
  468.  easter
  469.  ______________________________________________________________________________
  470.  
  471.  Usage:     easter
  472.             easter YY
  473.             easter YYYY
  474.  
  475.  Displays the full dates of Easter, Holy Thursday and Whitsunday.
  476.  
  477.  Default to current year. YYYY is valid from 1950 to 2049. YY default to 19xx
  478.  (50-99) or to 20xx (0-49)
  479.  
  480.  ______________________________________________________________________________
  481.  elimpr
  482.  ______________________________________________________________________________
  483.  
  484.   Usage:      elimpr
  485.  
  486.  I dislike that PrintScreen key, don't you ? Elimpr is a very slim resident
  487.  (26 bytes) which prevents its action.
  488.  
  489.  ______________________________________________________________________________
  490.  esctst
  491.  ______________________________________________________________________________
  492.  
  493.  Usage:    esctst  number letter ....
  494.  
  495.  Example:  esctst 27 C 66 >prn
  496.  
  497.  Esctst suppress blanks and prints args in binary form. Divert output to
  498.  printer or file or the like.
  499.  
  500.  ______________________________________________________________________________
  501.  ex1a
  502.  ______________________________________________________________________________
  503.  
  504.  Usage:    ex1a file_name
  505.  
  506.  Ex1a strips embedded end-of-files characters 1Ah.
  507.  
  508.  ______________________________________________________________________________
  509.  expose
  510.  ______________________________________________________________________________
  511.  
  512.  Usage:    expose file_name
  513.  
  514.  
  515.  Expose is a simply minded wiewer for ascii files. Printer commands imbedded
  516.  in the file are transparent to expose. Virtually all IBM PROPRINTER sequences
  517.  are made unvisible.
  518.  ______________________________________________________________________________
  519.  expr
  520.  ______________________________________________________________________________
  521.  
  522.  Usage:        expr
  523.  
  524.  Expr is a calculator which can evaluate an infix expression. You can freely
  525.  creates variables, by giving them a name in the left part of an expression.
  526.  Use logically the parenthesis.
  527.  
  528.  Grammar:
  529.  [variable =] expression
  530.  evaluates the expression and set the variable if present.
  531.  
  532.  Example:
  533.             (1 + sqrt 16) * 2
  534.  
  535.             r = (1 + sqrt 16) * 2
  536.             Then r receives the value and can be used later on like this:
  537.  
  538.                 result = r + 1
  539.  
  540.  Operators:  +  -  *  /  ^  (  )
  541.              acos - asin - atan - cos - sin - tan - cosh - sinh -
  542.              tanh - log - log10 - exp - ceil - fabs - floor - sqrt
  543.  
  544.  Constants:  PI, E , R2 or pi, e , r2
  545.  ______________________________________________________________________________
  546.  ext
  547.  ______________________________________________________________________________
  548.  
  549.  Usage:      ext [dummy]
  550.  
  551.  Displays all extensions used in the current directory. With a dummy arg,
  552.  recursively searchs subdirectories.
  553.  ______________________________________________________________________________
  554.  f13
  555.  ______________________________________________________________________________
  556.  
  557.  Usage:       f13
  558.               f13 YY
  559.               f13 YYYY
  560.  
  561.  Let's be straight. There in this world careless people who dont believe in
  562.  ghosts, who would start a new business on a Friday, or pat a black cat on the
  563.  left side of the street.
  564.  
  565.  You and me know better and appreciate f13. Try it.
  566.  
  567.  ______________________________________________________________________________
  568.  factor
  569.  ______________________________________________________________________________
  570.  
  571.  Usage:     factor number
  572.  
  573.  Factors numbers between 1 and 2,497,525,535.
  574.  
  575.  ______________________________________________________________________________
  576.  filesplit
  577.  ______________________________________________________________________________
  578.  
  579.  Usage:
  580.              filesplit file f1 f2  pattern_file
  581.  
  582.  copies file partially to f1 and f2 as defined in the pattern file.
  583.  
  584.  f1 will receive record whose keys compute to less or equal, f2 will receive
  585.  records whose keys compute to greater than the test key described in the
  586.  pattern file.
  587.  
  588.  The pattern file contains the record length, and, for each key, its type,
  589.  length, offset and content.
  590.  
  591.  For instance:
  592.                  226         ... record length
  593.                  14          ascii, ascending, uper case or lower case
  594.                  25          key length
  595.                  0           its offset
  596.                  2           unsigned short integer
  597.                  2           its length
  598.                  61          its offset
  599.  
  600.   Types are:
  601.  
  602.                          ascending           descending          length
  603.   ascii                          0                    7       arbitrary
  604.   signed short int               1                    8               2
  605.   unsigned short int             2                    9               2
  606.   long int                       3                   10               4
  607.   float                          4                   11               4
  608.   double                         5                   12               8
  609.   numerical date                 6                   13               2
  610.   ascii (uper or lower case)    14                   15       arbitrary
  611.  
  612.  
  613.  ______________________________________________________________________________
  614.  first
  615.  ______________________________________________________________________________
  616.  
  617.  Usage:     first mon[day]
  618.             first mon[day] YY MM
  619.             first mon[day] YYYY MM
  620.  
  621.  Displays the full date of the first specified week day of current month or of
  622.  specified month and year.
  623.  
  624.  YYYY is valid from 1950 to 2049. YY default to 19xx (50-99) or to 20xx (0-49)
  625.  
  626.  ______________________________________________________________________________
  627.  fltgraph
  628.  ______________________________________________________________________________
  629.  
  630.  Usage:        fltgraph   <input  >output
  631.  
  632.  fltgraph is a filter which replaces the semi-graphic characters by *, | or -.
  633.  
  634.  ______________________________________________________________________________
  635.  freedisk
  636.  ______________________________________________________________________________
  637.  
  638.  Usage:      freedisk
  639.  
  640.  Displays disk occupation, like:
  641.  
  642.  Disk C
  643.      15512 clusters
  644.          4 sectors / cluster
  645.        512 bytes / sector
  646.   31768576 bytes (total disk)
  647.     950272 bytes (unused)
  648.  
  649.  ______________________________________________________________________________
  650.  freemem
  651.  ______________________________________________________________________________
  652.  
  653.  Usage:      freemem
  654.  
  655.  Displays memory occupation, like:
  656.  
  657.  total memory:      524288
  658.  available memory:  433984
  659.  
  660.  ______________________________________________________________________________
  661.  gcd
  662.  ______________________________________________________________________________
  663.  
  664.  Usage:      gcd   number_1  number_2
  665.  
  666.  Computes the greatest common divisor of the two numbers.
  667.  
  668.  _____________________________________________________________________________
  669.  home
  670.  ______________________________________________________________________________
  671.  
  672.  Usage:       home
  673.  
  674.  Home is a customized menu which can be conveniently installed on the root
  675.  directory.
  676.  
  677.  Assuming you have three applications, home would present:
  678.  
  679.                                   ┌─────────────────┐
  680.                                   │ Word processing │
  681.                                   │ Invoicing       │
  682.                                   │ Graphics        │
  683.                                   └─────────────────┘
  684.  
  685.  Use the arrows to move in the list and Enter to select an item. (If they
  686.  all have different initials, you can use the first letter instead).
  687.  
  688.  To customise Home, type:
  689.  
  690.                            home  home.cmd
  691.  
  692.  home.cmd (or any other suitable name) would contain:
  693.  
  694.           word processing
  695.           c:
  696.           .
  697.           cd \wp
  698.           invoicing
  699.           c:
  700.           .
  701.           cd \inv
  702.           graphics
  703.           d:
  704.           cd \grph
  705.  
  706.  Rules:
  707.  
  708.       1. two lines for each command: one for the displayed text, one for
  709.          a DOS command or a program name.
  710.  
  711.       2. if more commands are needed, add a line with only a period and a line
  712.          for another command.
  713.  
  714.       3. a command like  ■prog  would execute the program 'prog'. This
  715.          should be avoided if prog is a very big program.
  716.  
  717.       4. in some configurations, you may find that your intended last command
  718.          in a sequence 'falls' upon the next sequence. Then terminates the
  719.          sequence by
  720.                           .
  721.                           exit
  722.  ______________________________________________________________________________
  723.  impcol
  724.  ______________________________________________________________________________
  725.  
  726.  Usage:
  727.                impcol [flags] file c1 c2 ....  [>output]
  728.                impcol [flags] file @param      [>output]
  729.                impcol config
  730.  
  731.  prints selected columns from a file.
  732.  
  733.  Example:
  734.                impcol file_x 80 92 50 62
  735.  
  736.  would displays columns 80-92 and 50-62 of file_x, using some formatting rules:
  737.  
  738.  1. impcol compares resulting width to 80, 96 and 132 and eventually sets
  739.  10cpi, 12cpi or 16cpi or fails with a warning.
  740.  
  741.  2. impcols returns to DOS the columns width it has selected (80, 96 ...)
  742.  
  743.  3. centers the text
  744.  
  745.  4. assumes a 72 lines paper (12') and a bottom margin of 5 lines.
  746.  
  747.  5. if semigraphic characters are used in source file, checks if the
  748.     four angles are ┌ ┐ └ ┘.
  749.  
  750.  Flags:
  751.           -tfile   insert file on top of output.
  752.           -fN      numbers pages
  753.           -g       replaces semi-graphics with *, - and |.
  754.           -mN      suppress centering and set left margin at N.
  755.           -hN      forces to   1 = 10 cpi, 2 = 12cpi et 3 = 16 cpi.
  756.           -l       assumes a 132 columns printer (default is 80) and
  757.                    uses 132, 160, 218.
  758.           -lN1,N2,N3   forces three other printer width formats.
  759.           -pm.c    m lines/page,  n lines bottom margin.
  760.  
  761.   Typing:
  762.                  impcol  config
  763.  
  764.   you may change permanently the default parameters.
  765.  
  766.  
  767.  Selected columns must be given by pairs. Their numbers is limited only by the
  768.  DOS command args limit. If you need more column spec, place them in a
  769.  separate file, params,  (each on a line) and use the syntax:
  770.  
  771.          impcol [flag] file_name @params
  772.  
  773.  ______________________________________________________________________________
  774.  impess
  775.  ______________________________________________________________________________
  776.  
  777.  Usage:         impess
  778.  
  779.  Impess is useful in testing printer adjustment before printing a large number
  780.  of preprinted forms.
  781.  
  782.  You might for instance have a batch file like:
  783.  
  784.                       :PRN_TST
  785.                       @impess  >prn
  786.                       @xprompt  N  Y  "Another try  ? (Y/N) "
  787.                       @if errorlevel 1 goto PRN_TST
  788.  
  789.  Impess would first be customized by typing:
  790.  
  791.                             impess config
  792.  
  793.  and filing parameters. Example:
  794.  
  795.                                   ┌────┐                      ┌──────┐
  796.  Characters per inch (10, 12, 16) │ 10 │      Lines per page  │  66  │
  797.                                   └────┘                      └──────┘
  798.                   ┌───────trial text───────┬─line──┬─column──┐
  799.                   │third line ------X      │  3    │   10    │
  800.                   │same--Y                 │  0    │   15    │
  801.                   │fifth line ------------Z│  5    │   0     │
  802.                   │                        │       │         │
  803.                   │                        │       │         │
  804.                   │                        │       │         │
  805.                   └────────────────────────┴───────┴─────────┘
  806.  
  807.  Test stops at the first empty trial text. Enter absolute number for the first
  808.  line, relative numbers afterwards (0 is same line). Column number is relative
  809.  whithin same line, absolute otherwise.
  810.  ______________________________________________________________________________
  811.  isafact
  812.  ______________________________________________________________________________
  813.  
  814.  Usage:   isafact  number
  815.  
  816.  Finds out if number is a factorial and displays its base.
  817.  ______________________________________________________________________________
  818.  keypack
  819.  ______________________________________________________________________________
  820.  
  821.  Usage:
  822.             keypack [-e] [-lN] [-m]  file_name   [>output]
  823.  
  824.  reads and formats a file made trough keyword.
  825.  
  826.  Flags:
  827.            -e   only eliminates multi-entries.
  828.            -lN  set text width to N characters (default is 79).
  829.            -m   change keywords to uppercase.
  830.  ______________________________________________________________________________
  831.  keyword
  832.  ______________________________________________________________________________
  833.  
  834.  Usage:
  835.  
  836.         keyword  [flags]  file  file ....
  837.  
  838.  read the listed files, display the text, stopping on each new word for the
  839.  operator to decide to retain or discard it.
  840.  
  841.  Output file is a list of retained words following their page number.
  842.  
  843.  Flags:
  844.         -kfile1     file for retained words; default: KEEP
  845.         -dfile2     file for discarded words; default: DISPOSE
  846.         -sfile3     output file; default: FKEY
  847.  
  848.         -fN         set the first page number to N
  849.         -l          writes line numbers rather than page numbers
  850.         -i          reverse process order (KEEP before DISPOSE)
  851.  
  852.  Page numbers are defined by formfeed character (decimal 12). If there is no
  853.  formfeed, use the -l flag.
  854.  
  855.  KEEP and DISPOSE can be edited and reused. See keypack for eliminating
  856.  multiple entries.
  857.  
  858.  ______________________________________________________________________________
  859.  laser
  860.  ______________________________________________________________________________
  861.  
  862.  Laser memorises and sends to printer command characters and control sequences.
  863.  
  864.  As a matter of fact, laser is useful with any kind of printers, not only
  865.  lasers.
  866.  
  867.  Usage:
  868.  
  869.      1.    laser ?
  870.  
  871.            Displays a help screen.
  872.  
  873.      2.    laser config
  874.  
  875.            To entrer commands. The screen would display the like:
  876.  
  877.  ─Symbol───── ─Description────────────────── ─Sequence─────────────────────
  878.  10           10 c.p.i.                      18
  879.  12           12 c.p.i.                      18,27,58
  880.  16           16 c.p.i.                      18,15
  881.  66           11 inches                      27,67,66
  882.  
  883.  Symbol is a short name (12 chars, no blank). Description shoud be self-
  884.  explanatory. Sequence must conform to your printer manuel spec.
  885.  
  886.  
  887.      3.    laser -x   laser.cmd
  888.  
  889.            Another way to enter commands. Laser.cmd is a text file, in the
  890.            exemple:
  891.                     10
  892.                     10 c.p.i.
  893.                     18
  894.                     12
  895.                     12 c.p.i.
  896.                     18,27,58
  897.                     16
  898.                     16 c.p.i.
  899.                     18,15
  900.                     66
  901.                     11 inches
  902.                     27,67,66
  903.  
  904.  
  905.      4.    laser
  906.  
  907.            Displays the column 'Description'.
  908.  
  909.            Use the arrows to move in the list, Enter to broadcast the
  910.            command, ESC to quit.
  911.  
  912.  
  913.      5.    laser  symbol  symbol ...
  914.  
  915.            broadcasts the commands corresponding to listed symbols.
  916.            Example:
  917.                       laser 66 12
  918.  
  919.  
  920.      6.    laser  -p  file_name  [>output]
  921.  
  922.            Laser works as a filter which translates printer commands
  923.            imbedded in the file. Those commands must be quoted with tilde (~)
  924.            like:
  925.  
  926.                 ~12~~66~text.....
  927.                 ...~16~.......
  928.  
  929.  ______________________________________________________________________________
  930.  last
  931.  ______________________________________________________________________________
  932.  
  933.  Usage:     last mon[day]
  934.             last mon[day] YY MM
  935.             last mon[day] YYYY MM
  936.  
  937.  Displays the full date of the last specified week day of current month or of
  938.  specified month and year.
  939.  
  940.  YYYY is valid from 1950 to 2049. YY default to 19xx (50-99) or to 20xx (0-49)
  941.  
  942.  ______________________________________________________________________________
  943.  lcm   least common multiple
  944.  ______________________________________________________________________________
  945.  
  946.  Usage:     lcm   number_1   number_2
  947.  
  948.  Computes the least common multiple of the two numbers.
  949.  
  950.  ______________________________________________________________________________
  951.  litteral
  952.  ______________________________________________________________________________
  953.  
  954.  Usage:    litteral number [units] [fracts]
  955.  
  956.  Displays full written form of a number.
  957.  Example:
  958.           litteral 1234.56
  959.           litteral 1234.56 $
  960.           litteral 1234.56 $ cts
  961.  ______________________________________________________________________________
  962.  modulo
  963.  ______________________________________________________________________________
  964.  
  965.  Usage:     modulo number_1 number_2
  966.  
  967.  Displays the remainder or the division number_1 / number_2
  968.  
  969.  ______________________________________________________________________________
  970.  mvdir
  971.  ______________________________________________________________________________
  972.  
  973.  Usage:   mvdir  path_1\filename_1  path_2\filename2
  974.  
  975.  
  976.  Moves filename_1 to the directory designated by path_2, changing its name in
  977.  the process. Path_1 and path_2 must be on the same drive.
  978.  
  979.  ______________________________________________________________________________
  980.  pgpr
  981.  ______________________________________________________________________________
  982.  
  983.  Usage:     pgpr   file_name  page_1  page_2
  984.  
  985.  Prints one or several printer pages from a file. Pages are defined by
  986.  formfeed charactere (decimal 12)
  987.  
  988.  ______________________________________________________________________________
  989.  primes
  990.  ______________________________________________________________________________
  991.  
  992.  Usage:       primes
  993.               primes number
  994.  
  995.  Displays primes numbers less than 'number' (default to 10000)
  996.  
  997.  ______________________________________________________________________________
  998.  removetab
  999.  ______________________________________________________________________________
  1000.  
  1001.  Usage:
  1002.             removetab  [-e ou -nN] [dummy arg]
  1003.  
  1004.  reads standard input and write to standard output, replacing the tabs by an
  1005.  appropriate number of blanks.
  1006.  
  1007.  Flags:
  1008.           -e      to be used if the source file has been made with edlin
  1009.           -nN     N being the number (1-32) of blanks (default is 8)
  1010.           dummy arg displays a help screen.
  1011.  ______________________________________________________________________________
  1012.  split
  1013.  ______________________________________________________________________________
  1014.  
  1015.  Usage:
  1016.               split  infile  file1  file2  length [factor]
  1017.  
  1018.  copies infile  to file1 from 0 to length - 1
  1019.                 to file2 from length to end of infile
  1020.  
  1021.  If factor is present, length is multiplicated by factor, allowing a record
  1022.  * length definition.
  1023.  
  1024.  One of file1 or file2 may be the NUL device.
  1025.  
  1026.  ______________________________________________________________________________
  1027.  strip
  1028.  ______________________________________________________________________________
  1029.  
  1030.  Usage:
  1031.                strip [-d] file_name [>output]
  1032.  
  1033.  Strips off control characters and escape sequences. Virtually all IBM
  1034.  PROPRINTER sequences are recognized.
  1035.  
  1036.  With -d flag, replaces formfeed by new line.
  1037.  
  1038.  ______________________________________________________________________________
  1039.  touch
  1040.  ______________________________________________________________________________
  1041.  
  1042.  Syntax:
  1043.               touch [-dMM/JJ/AA] [-hHH:MM:SS] file ...
  1044.  
  1045.  changes date and time of designated files.
  1046.  
  1047.  Without flags, uses the system date and time.
  1048.  
  1049.  Flags:
  1050.              -d     uses specified date
  1051.              -h     uses specified time
  1052.  
  1053.  ______________________________________________________________________________
  1054.  tstarg
  1055.  ______________________________________________________________________________
  1056.  
  1057.  Usage:        tstarg %1 %2 %3 ...
  1058.  
  1059.  Counts args and returns their numbers.
  1060.  
  1061.  Example:
  1062.                @tstarg %1 %2 %3 %4
  1063.                @if error_level 4 ...
  1064.                @if error_level 3 ...
  1065.                ....
  1066.  
  1067.  ______________________________________________________________________________
  1068.  tstempty
  1069.  ______________________________________________________________________________
  1070.  
  1071.  Usage:       tstempty    file_name
  1072.  
  1073.  Example:
  1074.               @tstempty   \dir1\file1
  1075.               @if errorlevel 2 ...
  1076.               @if errorlevel 1 ...
  1077.  
  1078.  tstempty returns:
  1079.  
  1080.               2  if file_name is empty
  1081.               1  if file_name does not exist
  1082.               0  otherwise
  1083.  
  1084.  ______________________________________________________________________________
  1085.  ucopy
  1086.  ______________________________________________________________________________
  1087.  
  1088.  Usage:
  1089.               ucopy   file_name  record_length   drive:
  1090.  
  1091.  Example:
  1092.               ucopy   manual    512   a:
  1093.  
  1094.  
  1095.  Copies big files to several removable disks. (copy back from ucopy disks can
  1096.  be made with 'copy ' for the first and 'concat' for the others).
  1097.  
  1098.  During copying, ucopy totaly deletes destination disk. (the last ucopy disk
  1099.  should not be used for another ucopy)
  1100.  
  1101.  Ucopy labels disks ucopy_001 etc.
  1102.  
  1103.  Record_length is used to round up each disk to a integer number of records.
  1104.  Ucopy checks record_length for consistency and stops if there is an error.
  1105.  
  1106.  However, if record_length is 512, no check is made. Use 512 to copy files
  1107.  with no fixed record definition.
  1108.  
  1109.  ______________________________________________________________________________
  1110.  where
  1111.  ______________________________________________________________________________
  1112.  
  1113.  Usage:         where  filespec
  1114.  
  1115.  Looks for specified files (wildcards allowed) in the current directory and
  1116.  its subdirectories.
  1117.  ______________________________________________________________________________
  1118.  xdate
  1119.  ______________________________________________________________________________
  1120.  
  1121.  Usage:         xdate
  1122.  
  1123.  Shows the numerical parameters of a date (between 1/1/1901 and 6/3/2080):
  1124.  
  1125.  
  1126.        ┌──date──┬─D/P─┬lpy┬─────────┬wk─┬D/Y┬─last Y─┬─last M─┬─this M─┐
  1127.        │03 16 92│33313│0  │Monday   │11 │76 │   33237│   33297│   33328│
  1128.        └────────┴─────┴───┴─────────┴───┴───┴───end──┴───end──┴───end──┘
  1129.  
  1130.  and a command bar
  1131.                            ┌─────────────────────────┐
  1132.                            │ Date   Period day   End │
  1133.                            └─────────────────────────┘
  1134.  
  1135.  to select another date or another day-of-the-period.
  1136.  
  1137.  ______________________________________________________________________________
  1138.  xdel
  1139.  ______________________________________________________________________________
  1140.  
  1141.  Usage:
  1142.            xdel [-q  -r -d] file ...
  1143.  
  1144.  deletes specified files in the current directory after a Yes/No prompt.
  1145.  
  1146.  Flags:
  1147.          -q    requests global confirmation once,
  1148.                    instead of individual prompts.
  1149.          -r    recursively deletes files in the subdirectories.
  1150.          -d    removes subdirectories if empty.
  1151.  
  1152.  ______________________________________________________________________________
  1153.  xfind
  1154.  ______________________________________________________________________________
  1155.  
  1156.  Usage:      xfind  filespec [anywhere]
  1157.  
  1158.  
  1159.  Finds all specified files (wildcards allowed) in the current directory and
  1160.  its sub-directories.
  1161.  
  1162.  With the 'anywhere' clause, searchs the entire disk.
  1163.  
  1164.  If no wildcard has been used, indicates the most recent version and prompts
  1165.  to update others, one at a time.
  1166.  
  1167.  If no wildcard has been used and two or more files are identical, prompts to
  1168.  delete all but one, one at a time.
  1169.  
  1170.  ______________________________________________________________________________
  1171.  xprint
  1172.  ______________________________________________________________________________
  1173.  
  1174.  Usage:    same as print ( >prn )
  1175.  
  1176.  xprint takes care of presence or absence of IBM LAN and emit a simple print
  1177.  or a net print ... prn, as appropriate.
  1178.  
  1179.  ______________________________________________________________________________
  1180.  xprompt
  1181.  ______________________________________________________________________________
  1182.  
  1183.  Usage:     xprompt   template_1   template_2   message
  1184.  
  1185.  Example:   @xprompt  black   white    "Is your car black or white ? "
  1186.             @if errorlevel 1 ....
  1187.  
  1188.  Displays the message and waits for key entry, which must be one of the
  1189.  templates, upper or lower case. Returns 0 or 1 accordingly.
  1190.  
  1191.  ______________________________________________________________________________
  1192.